home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d2
/
treet243.arc
/
TREETOP.MAN
< prev
next >
Wrap
Text File
|
1991-03-01
|
103KB
|
2,182 lines
TreeTop
USER'S MANUAL
Kilgore Software
P.O. Box 2291
West Sacramento, CA 95691
(916) 371-3715
Copyright 1989
TreeTop
All rights reserved, worldwide.
Notice of Liability: The information in this manual and the TreeTop
software package is distributed on an "As Is" basis, without
warranty. Neither the author nor Kilgore Software shall have any
liability to any person or entity with respect to any liability,
loss, or damage caused or alleged to be caused directly or indirectly
by the instructions in this manual or the software itself.
Published by Kilgore Software
Copyright (c) 1989 by Kilgore Software
Version 2.34
ISBN 0-9624863-0-2
IBM, IBM-PC, PC-DOS are trademarks of International Business Machines
MS-DOS is a trademark of Microsoft Corporation
TreeTop
TreeTop is a shareware (user supported) product. You are granted a
free 30 day license to use TreeTop and you may make as many copies as
you like. You may also distribute copies of TreeTop to other users
as long as you accept no compensation from them. If you find TreeTop
useful and wish to continue using it after the 30 day license period,
you may obtain a permanent registration (and manual) by submitting
the license agreement (see file TREETOP.DOC) and appropriate
registration fee to:
Kilgore Software
P.O. Box 2291
West Sacramento, CA 95691
(916) 371-3715
or call toll free:
1-800-TREETOP
Registration, disks, and manual ........... $39.00
Contents
======================================================================
1 Introduction
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
What Is Shareware . . . . . . . . . . . . . . . . . . . . . . 2
TreeTop Registration . . . . . . . . . . . . . . . . . . . . . 2
If You're New to DOS . . . . . . . . . . . . . . . . . . . . . 2
Executing TreeTop . . . . . . . . . . . . . . . . . . . . . . 3
Point and Shoot Interface . . . . . . . . . . . . . . . . . . 3
Context Sensitive Online Help . . . . . . . . . . . . . . . . 4
The <ESC> Key . . . . . . . . . . . . . . . . . . . . . . . . 4
The Mouse Interface . . . . . . . . . . . . . . . . . . . . . 4
Pull Down Menus . . . . . . . . . . . . . . . . . . . . . . . 5
2 Installation
System Requirements . . . . . . . . . . . . . . . . . . . . . 6
Initial Installation . . . . . . . . . . . . . . . . . . . . . 6
Installing a Mouse . . . . . . . . . . . . . . . . . . . . . . 8
User Setup . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3 Directory Operations
The Directory Service Screen . . . . . . . . . . . . . . . . 11
Select a Directory . . . . . . . . . . . . . . . . . . . . . 13
Select All Directories (Global) . . . . . . . . . . . . . . 13
Add a Directory . . . . . . . . . . . . . . . . . . . . . . 14
Delete a Directory . . . . . . . . . . . . . . . . . . . . . 14
Rename a Directory . . . . . . . . . . . . . . . . . . . . . 15
4 File Operations
The File Service Screen . . . . . . . . . . . . . . . . . . 16
About File Operations . . . . . . . . . . . . . . . . . . . 18
About Tagging Files . . . . . . . . . . . . . . . . . . . . 18
Tag/Untag a Single File . . . . . . . . . . . . . . . . . . 20
Tag/Untag Multiple Files . . . . . . . . . . . . . . . . . . 21
Set File Display . . . . . . . . . . . . . . . . . . . . . . 23
Retag Files . . . . . . . . . . . . . . . . . . . . . . . . 23
Find a File . . . . . . . . . . . . . . . . . . . . . . . . 24
Edit a File . . . . . . . . . . . . . . . . . . . . . . . . 24
Execute a File . . . . . . . . . . . . . . . . . . . . . . . 25
Set File(s) Attributes . . . . . . . . . . . . . . . . . . . 26
Set File(s) Date/Time . . . . . . . . . . . . . . . . . . . 27
Set File Selection Masks . . . . . . . . . . . . . . . . . . 28
Set Tagged File Mask . . . . . . . . . . . . . . . . . . . . 30
Sort Files . . . . . . . . . . . . . . . . . . . . . . . . . 30
Copy File(s) . . . . . . . . . . . . . . . . . . . . . . . . 31
Move File(s) . . . . . . . . . . . . . . . . . . . . . . . . 33
Delete File(s) . . . . . . . . . . . . . . . . . . . . . . . 34
Print File(s) . . . . . . . . . . . . . . . . . . . . . . . 35
Rename a File . . . . . . . . . . . . . . . . . . . . . . . 35
File Speed Search . . . . . . . . . . . . . . . . . . . . . 36
Hex File Dump . . . . . . . . . . . . . . . . . . . . . . . 36
View a File . . . . . . . . . . . . . . . . . . . . . . . . 37
Contents cont.
======================================================================
5 Miscellaneous Operations
Registration Information . . . . . . . . . . . . . . . . . . 39
Available Disk Space . . . . . . . . . . . . . . . . . . . . 39
Logging to a Different Drive . . . . . . . . . . . . . . . . 39
Setting the Disk Volume Label . . . . . . . . . . . . . . . 40
Scanning the Current Drive . . . . . . . . . . . . . . . . . 40
Shelling to DOS . . . . . . . . . . . . . . . . . . . . . . 40
Exiting TreeTop . . . . . . . . . . . . . . . . . . . . . . 41
INDEX TO OPERATIONS . . . . . . . . . . . . . . . . . . . . . . 42
Section 1
Introduction
=====================================================================
Overview ------------------------------------------------------------
TreeTop provides a powerful, quick and easy to use interface between
you and your computer's operating system. TreeTop's menus use single
key commands to perform most file and directory operations with a
fraction of the keystrokes required by DOS. The graphic
representations and "Point and Shoot" interface help even the newest
users of DOS understand and manipulate directories and files. Mouse
users can take advantage of TreeTop's full mouse interface. Whether
you are doing hard disk housekeeping, reorganizing your directory
structure, or simply copying files, TreeTop makes it a breeze. Some
of the features found in TreeTop are:
o Fast and user friendly
o Pull down menus
o Context sensitive help
o User installable setup
o Full color or monochrome support
o Shell to DOS
o Execute COM, EXE, and BAT files
o Mouse support (not required)
o Sort files by name, extension, size, date/time, ascending or
descending order
o Copy, move, delete, rename, or print single files or groups of
files
o Add, delete, and rename directories
o Select and operate on files in a single directory or in the
entire logical drive
o Select files by wildcards, date/time, attributes, or
individually
o Change file's date/time or attributes
o Find files with speed searching
o Disk and directory status display
o View files in hex or text format
o Set, rename or delete disk volume labels
page 2
What is Shareware ---------------------------------------------------
Shareware is commercially available software usually sold directly
from the software company or the author. With shareware, the user
has the advantage of fully testing the software on his system, at his
leisure, before he makes a decision to purchase it. The user may
obtain the software from any source, such as electronic bulletin
boards or other users, and evaluate it free of charge for a period of
time (typically 30 days) to determine if it fits his or her needs.
At the end of the evaluation period, he must purchase the software if
he wishes to continue using it, or remove it entirely from his
computer(s) and discontinue its use. If it does fit his needs and he
purchases the software, he is entitled to the privileges outlined in
the purchase/license agreement. Typically, this includes
documentation and the latest version, technical telephone support,
and notifications of updates or changes that the user may be
interested in. Users of shareware are encouraged to distribute
copies of the software, as per the license agreement, to other
potential users for evaluation purposes only.
TreeTop Registration ------------------------------------------------
TreeTop is a commercial shareware product that represents a very
significant investment of time and money. Thousands of man-hours
have been devoted to its design, programming, testing, and
distribution. Many more hours will be spent on user support and
software updates. The shareware marketing concept for TreeTop can
only work if you, the user, register when you decide to continue
using it. By registering, you will help offset the initial
development costs and support the development of enhancements and
updates. As a registered TreeTop user, you will have the privilege
of technical telephone support as well as notifications of changes
and updates. Please see the Purchase/License agreement supplied on
the TreeTop disk (filename TREETOP.DOC) for specific details if you
have not already registered.
If You're New to DOS ------------------------------------------------
DOS (Disk Operating System) is the system that controls your computer
and its peripheral devices. When using your computer for word
processing, accounting, or any other applications, you create data
files associated with them. DOS manages the computer's disk drives
and the files they contain and consists of a set of commands that are
normally typed in along with the file and directory name you wish to
operate on. Using DOS can be a tedious and time consuming process,
and it's easy for the unwary user to make errors from which its
difficult to recover. By using a set of menus with single key
commands and user prompts, TreeTop eliminates most of the keystrokes,
reducing of the chance for error.
page 3
Directories and Files
Hard disks found on microcomputers today can accommodate thousands of
files. Keeping track of many files in a single location is unwieldy,
so DOS allows you to divide your hard disk (or a floppy disk, for
that matter) into a series of directories and subdirectories where
similar types of files can be grouped. For example, word processing
data can be stored separately from spreadsheets and drawings.
This method of directory and file management is commonly called
"tree" structured. Your diskette or hard disk can be thought of as
having a base or root which branches into smaller and smaller areas
in which files can be stored - and hence the name TreeTop.
You can also think of your diskette or hard drive as a file cabinet
with a set of drawers (the directories.) Each drawer can hold file
folders (the subdirectories) which can in turn hold more file folders
or your individual files. The only limit to the number of branches
(directories and files) your hard disk may contain is the size of the
disk.
That's about all the DOS information you need to understand to get
started using TreeTop effectively. If you have additional questions
about DOS, refer to your DOS User Reference.
Executing TreeTop ---------------------------------------------------
When properly installed, TreeTop can be executed at the DOS prompt
from anywhere on your system (See Initial Installation under the
Installation Section.) Normally you only need to type TT then press
<ENTER> to execute (or run) TreeTop. TreeTop automatically scans
your logged drive for all files and directories. If you wish
TreeTop to automatically scan a drive you are not logged onto, you
can type TT [drive] <ENTER> (where the drive is actually the drive
letter and you don't type the brackets.) You can also change the
logged drive after TreeTop has loaded (See Logging to a Different
Drive under Miscellaneous Operations.)
Point and Shoot Interface -------------------------------------------
TreeTop was designed around a visual "directory tree" image of your
hard disk. Using this directory tree structure, you can easily
execute nearly every command with the "Point and Shoot" concept.
When you first run TreeTop, the Directory Service Screen is displayed
with a graphical representation of the directory structure of your
hard disk. The logged directory when you executed TreeTop will be
highlighted on this tree. If you wish to list the files in a
different directory, simply move the highlighted bar to the desired
directory using the arrow keys or click on that directory with your
mouse cursor. This is the "Point" part of the "Point and Shoot."
page 4
Now press <ENTER> or click again on the highlighted directory with
your mouse cursor to change to the File Service Screen; the "Shoot"
part of the "Point and Shoot." This gives a sorted list of files for
that directory. You can do many other operations as well. For
example, if you want to delete the directory that is highlighted, you
would press D to delete it. It's that easy. The same "Point and
Shoot" interface also applies to the File Service Screen. If you
want to copy a single file, you would first highlight that file using
the arrow keys or click on the desired file with your mouse cursor
(the "Point" part), then press C or click on Copy with your mouse
cursor (the "Shoot" part.) You would then be prompted for the
destination to copy to. There are many directory and file operations
you can execute in this manner, with shortcuts to help speed things
along.
Context Sensitive Online Help ---------------------------------------
TreeTop provides a generous amount of online help when needed.
Hopefully, you will not have to use the help often because TreeTop is
designed to be as intuitive as possible. However, if you want help,
simply press F1 at any time for a help screen. TreeTop will display
a help screen that best fits the context of where you are in the
program. You are not limited to that help screen. If you want other
help, you may press I while viewing any help screen to get an index
of other help screens. This index is actually a menu from which you
can view any help screen. When done viewing help, press <ESC> to
return.
The <ESC> Key -------------------------------------------------------
The escape key <ESC> is a very important key for TreeTop. It is used
for returning to a previous screen, exiting TreeTop, backing out of
an operation you selected, or cancelling an operation that is
currently running. Basically its a safety key you can hit whenever
you start something that you don't want to finish. Selecting a menu
item will often prompt you for a Yes/No answer. Pressing the escape
key will cancel that prompt altogether and return you to the screen
you were working from. You don't have to worry about whether or not
you should cancel an operation while it is running. If you don't
understand a prompt, or you want to stop what you have started, just
press <ESC>.
The Mouse Interface -------------------------------------------------
If your computer has a mouse, you can make even better use of
TreeTop. Generally speaking, you can move the mouse cursor to a menu
item on the screen, click on that item (press the left mouse button)
and accomplish the same thing as pressing the highlighted key for
that menu item. You can also select the highlighted directory or
file by simply moving the mouse cursor to the desired directory or
file and clicking on it. If the desired directory or file is not in
view on your screen, you can scroll to it by clicking just outside of
page 5
the box that surrounds the files or directories. If you keep your
finger down on the left button, it will continue to scroll
automatically until you release the button. Pressing the right mouse
button is exactly the same as pressing <ESC> at the keyboard. This
gives you the ability to operate TreeTop using the mouse with
virtually no keyboard interaction. The only time you must use the
keyboard is to type file or directory names when prompted to do so,
or when selecting help screens from within help.
Pull Down Menus -----------------------------------------------------
TreeTop utilizes pull down menus. These menus are designed to be
fast and easy to use by both mouse and non-mouse users. In all
cases, the pull down menu will give you a vertical list of items to
choose from. You may select a menu item by pressing the highlighted
key for that item or by moving the highlighted menu bar (using your
up and down arrow keys) to that item and pressing <ENTER>. If you
have a mouse, you can drag the highlighted bar to the desired menu
item, then select it by pressing the left mouse button. If you
change your mind and do not want to make a selection on the pull down
menu, just press your right mouse button, or select the <ESC> CANCEL
menu item, or just press <ESC> at the keyboard.
Some of the pull down menus will execute your request immediately
upon selection. Other pull down menus require you to accept your
selections with the <TAB> ACCEPT option at the bottom of the menu.
The menus that require you to accept selections do so because there
are multiple choices possible. This gives you the ability to select
several items on the menu; when you have finished, select the bottom
line, <TAB> ACCEPT, to confirm your choices. You can also press
<ESC> to cancel the menu.
Section 2
Installation
=====================================================================
System Requirements -------------------------------------------------
TreeTop is compatible with IBM PC computers and IBM PC clones that
use the PC-DOS or MS-DOS operating system (often just called DOS
computers.) Your computer must have at least 256K RAM and be running
a DOS operating system version 2.0 or greater. Computers that have a
large number of files on the hard drive (i.e., over 1000) may need
slightly more memory than 256K RAM. Although TreeTop will run just
fine on a "floppy-only" computer system, you will be better able to
make use of TreeTop if your computer has a hard disk drive as well.
TreeTop will operate on most video cards and can be used on
monochrome or color monitors. TreeTop will run fine on a monochrome
display adapter or a Color Graphics Adapter (CGA), but it will
provide the best display if you are using an Enhanced Graphics
Adapter (EGA) or a Video Graphics Adapter (VGA) card.
Initial Installation ------------------------------------------------
This installation describes how to load TreeTop onto your hard disk
drive and modify your AUTOEXEC.BAT file so that it will run at its
optimum performance. TreeTop consists of three files that must be on
your hard disk drive for proper operation and two other files that
you may want to include for easy reference. These files are listed
below with a brief explanation for each of them:
1) TT.EXE This is the main executable file that is run when
you execute TreeTop.
2) TREETOP.HLP This is the file that contains the online, context
sensitive help for TreeTop. If this file is not on
your hard disk drive, TreeTop will still operate
properly, but you won't have any online help.
page 7
3) TREETOP.PAR This file contains the user defined setup parameters
for TreeTop. It is created automatically if it
doesn't already exist when you save the setup
parameters. (See the next section on user setup.)
4) TREETOP.DOC This is a text file that has a copy of the
Purchase/License agreement for TreeTop.
5) README.TXT This file contains the latest information on TreeTop
that may not be reflected in the bound manual.
There are two installation requirements that must be met for TreeTop
to operate properly on your computer. You must first copy the file
TT.EXE to a directory on your hard disk drive that is included in the
global path variable. That will insure the execution of TreeTop from
anywhere on your system. The second requirement is that you set up
an environment variable that instructs TreeTop to find its help
(TREETOP.HLP) and parameter (TREETOP.PAR) files in the correct
directory.
The easiest way to install TreeTop is to create a directory on your
hard disk drive called TREETOP, then copy all of the above files to
that directory. You must also edit your AUTOEXEC.BAT file to include
the directory TREETOP in the path command and set an environment
variable that tells TreeTop where to find its files. You can do this
by following the steps outlined below:
1) Choose the drive on which you wish to install TreeTop. The
following example assumes drive C:. Note: After each command
listed below, press <ENTER> to execute.
2) Create the TREETOP directory by using the "make directory"
DOS command, MD.
MD C:\TREETOP
3) You can now copy all the files from your master floppy to
the TREETOP directory using the DOS copy command. If your
master disk is in floppy drive A:, type
COPY A:*.* C:\TREETOP
4) You must also edit your AUTOEXEC.BAT file so that each time
you boot the computer TreeTop will know where to find its help
and parameter files. To do this , include the following line in
your AUTOEXEC.BAT file:
SET TREETOP=C:\TREETOP
5) The last thing you must do is edit the path command in your
AUTOEXEC.BAT file to include the directory, C:\TREETOP; in the
path variable.
You should reboot your computer when you have completed the above
five steps. After rebooting, you can run TreeTop by simply typing TT
from the DOS prompt anywhere on your system.
page 8
Note: You should only edit your AUTOEXEC.BAT file in a non-document
ASCII mode (also known as DOS ASCII or text mode.) If you are not
familiar with your autoexec.bat file or how to edit it, you should
read your DOS manual and/or get some help from a knowledgeable
person. Most editors or word processors provide a way to edit files
like autoexec.bat. Check your editor or word processor manual if you
are not sure.
Installing a Mouse --------------------------------------------------
To use your mouse with TreeTop, you must first load the standard
Microsoft (or Microsoft compatible) mouse driver. There are two
different ways to load a mouse driver. The first and most common way
is to include a line in your CONFIG.SYS file that instructs the
operating system to load the mouse driver every time you boot. The
other way is to execute a .COM file from the system prompt or from
your AUTOEXEC.BAT file that loads the mouse driver. See the manual
that accompanied your mouse for specific instructions on how to load
your mouse driver.
User Setup ----------------------------------------------------------
The user setup is different than the initial installation because it
allows you to customize certain default conditions that TreeTop will
use each time it is run. The user setup is not mandatory since the
default setup on your master disk is configured for common settings.
You may not need to make any changes, although you should at least
view your choices.
To examine the current settings for TreeTop, simply run TreeTop by
typing TT at your system prompt. Then, from the Directory Service
Screen, select the setup menu by pressing Alt-S (press and hold down
the Alt key, then press the S key while the Alt key is still
depressed.)
After you have examined the setup options and made any desired
changes, press <TAB> to accept all of your settings. If you wish to
cancel these settings, press <ESC>. If you press <TAB> to accept the
new settings, TreeTop will ask if you wish to save these settings to
disk. Answer Yes to save the changes to the TREETOP.PAR file for
future reference. If you answer No, TreeTop will only use those
settings for the rest of your current session and will forget them
when you quit.
page 9
The following is a list of the four setup options and a description
of each:
o General setup parameters
o Editor setup
o Sort file setup
o Attribute mask setup
o General Setup Parameters
The General setup allows you to set seven different options. An
option is selected if there is a check mark next to it. You may
toggle the selection on or off using your mouse and left mouse button
or the arrow and <ENTER> keys. When finished, press <TAB> to ACCEPT
your choices or <ESC> to CANCEL them (See The Mouse Interface and
Pull Down Menus under Introduction.) These options are described
below:
1) Show files on directory
This option will display the first eighteen files of each directory
in the window on the right side of Directory Service Screen. These
files are displayed in the order that they exist on your disk drive
(not sorted.)
2) Sorted directory tree
Causes the directory tree to be sorted and displayed in alphabetical
order. This does not actually change the order stored on the disk.
3) Extended file display mode
Sets the display mode on the File Service Screen to show the user the
size, date, time and attribute settings for files as well as the
full filenames.
4) Overwrite existing files
When set, TreeTop will automatically overwrite an existing file in a
destination directory if that filename is the same as the file being
copied. Treetop's default setting, however, will prompt you when
this situation arises. You may disarm this safety feature and allow
overwriting without being prompted.
5) Sound effects
Causes sound effects to be generated when doing certain operations
such as changing from one screen to another.
6) Color Monitor
If you have a color monitor, check this option. If you have a
monochrome monitor, you probably don't want this option, however,
some monochrome display adapters function well in the color mode, so
it may be worth a try.
page 10
7) LPT1 or LPT2
This selection allows you to set which port TreeTop will send to for
printing files. Select the port your printer is connected to.
o Editor Setup
The Editor setup allows you to enter the name of your favorite text
editor. This will give TreeTop the ability to execute your editor
automatically if you wish (see Edit File under File Operations.)
o Sort File Setup
The Sort file setup gives various options of how files are sorted on
the File Service Screen. Check the sort options you prefer and press
<TAB> to accept the setting.Note: You can temporarily override
these settings while using TreeTop if you wish (see Sort Files under
File Operations.)
o Attribute Mask Setup
The attribute mask setup allows you to selectively weed out files to
be viewed by TreeTop. TreeTop will still know about these files but
it will not display them on the File Service Screen. Select the
attribute or attributes of files that you wish to weed out, and
TreeTop will skip by them automatically. Normally, the only files
you will want to weed out are HIDDEN or SYSTEM files. The default
setup is configured to weed out HIDDEN files.
Section 3
Directory Operations
=====================================================================
The Directory Service Screen ----------------------------------------
All directory operations are executed from the Directory Service
Screen. You may add, delete, or rename a directory from this screen.
The root directory is always present and you cannot rename or delete
it. If you try, TreeTop will ignore your request.
The Directory Service Screen is displayed by TreeTop when first
entering the program and must be displayed anytime you're performing
directory operations. The six major areas of the Directory Service
Screen are:
1) Drive Status Box
2) Directory Status Box
3) Directory Display
4) File List
5) Directory Pathname
6) Menu Bar
Drive Status Box - The drive status box found at the left side of the
screen gives information on: 1) the current logged drive and its
volume label, 2) the total number of files on the drive and their
cumulative size in bytes, including system and hidden files, and 3)
the total number of tagged files and their cumulative size in bytes.
Directory Status Box - The directory status box also found at the
left side of the screen displays the name of the currently
highlighted directory and the following specific information about
that directory: 1) the date and time the directory was created on
your drive, 2) the total number of files contained in that directory
including system and hidden files and their cumulative size in bytes,
and 3) the number of tagged files in that directory and their
cumulative size in bytes.
page 12
Note: Some copy protection schemes use hidden or read/only
directories which may have directory names containing non-ASCII
characters. Most programs do not see these special directories, so
you may not even know they exist until you run TreeTop. TreeTop will
alert you to these directories (if any exist) by flashing the
directory name in the directory status box. DO NOT ATTEMPT to delete
or rename these special directories unless you know why they exist
and how to recreate them properly. If you do attempt to delete or
rename one of these directories, TreeTop will warn you, giving you a
chance to change your mind. Remember, if you do delete or rename a
directory like this, TreeTop will not be able to recreate it.
Directory Display - The center section of the screen shows a "tree"
structured layout of the directories and subdirectories of the logged
drive. The current logged directory when you loaded TreeTop will be
highlighted. The up, down, left, and right arrow keys and the
PageUp, PageDown, Home, and End keys are used to change the
highlighted directory. The left and right arrow keys move through
every directory on the tree, one directory at a time. The up and
down arrow keys move the highlight bar vertically to a directory of
the same level in the tree. You can use your PageUp, PageDown, Home
and End keys to jump through the directories.
Mouse Users: You may simply click on a given directory to highlight
it, then click again on the highlighted directory to
select it. If the directory is not visible on the
screen, you can scroll to it by clicking (or holding
down the left mouse button) just outside the box (but
not on the top menu bar.) Clicking at the top or
bottom of the box is the same as using the up or down
arrow keys, while clicking at the left or right of the
box is the same as using the left or right arrow keys.
File List - The list of files found in the highlighted directory is
displayed in the column at the extreme right side of the screen.
These files are displayed regardless of how the file or attribute
masks are set. They are not sorted at this point but are in the
actual order that they exist on your disk drive. This list of files
is intended to function as a reminder of what files, if any, exist in
a given directory. You cannot, for example, delete a directory if any
files appear in this box. If you wish to view the files in sorted
order or execute file operations, press <ENTER> to select the File
Service Screen for the highlighted directory.
Note: If you do not wish to have the file list displayed, you may
turn it off by changing your setup (see User Setup under the
Installation section.)
Menu Bar - The menu items are displayed on two lines near the top of
the screen. The single letter command or function key required to
select a menu item is highlighted for quick reference. Typing the
first letter of a menu selection will execute most commands.
Directory Pathname - The full pathname of the highlighted directory
is shown on the bottom line of the screen.
page 13
Select a Directory --------------------------------------------------
Command: <ENTER>
Screen: Directory Service Screen
Synopsis: Selects the File Service Screen for the highlighted
directory
Choosing the select option (press <ENTER> from the Directory
Service Screen) will select the highlighted directory. The File
Service Menu and the filenames from the selected directory will be
displayed. (see the File Operations section for instructions on using
the File Service Menu.)
Select All Directories (Global) -------------------------------------
Command: G
Screen: Directory Service Screen
Synopsis: Selects the File Service Screen for all directories
on the logged drive
Select the Global option (press G from the Directory Service Screen)
to select all the directories for the logged drive. The File Service
Screen and the selected files for the entire logged drive will be
displayed. This is handy, for example, if you wish to sort the files
or find a given file on the drive regardless of what directory it is
in. For example, assume you want to find the largest file on the
logged drive. You would first select the Global option then sort the
files by size, in descending order. The file at the top of the screen
is your largest file. (See the File Operations section for
instructions on using the File Service Screen.)
page 14
Add a Directory -----------------------------------------------------
Command: A
Screen: Directory Service Screen
Synopsis: Adds a sub-directory to the highlighted directory
Highlight the directory on the Directory Service Screen that will
become the parent to the directory you want to add then select the
Add option (press A from the File Service Screen) to add a
sub-directory. The screen will be reformatted to include another
directory and the cursor will be positioned on the screen for you to
add the new directory name. Type in the name you wish and press
<ENTER>. If the name is valid and does not conflict with other
directory names, it will be added and displayed on the screen. When
there is a problem with the name you chose, a warning message will be
displayed and you will be given a chance to edit your entry. If your
user setup specifies that the directories are displayed in
alphabetical order, you may re-scan your drive with the ScaN option
to display the new directory in alphabetical order. If you change
your mind and elect not to add a directory before completing the
operation, just press <ESC> to cancel.
Delete a Directory --------------------------------------------------
Command: D
Screen: Directory Service Screen
Synopsis: Deletes the highlighted directory
To delete a directory, simply highlight the directory on the
Directory Service Screen that you wish to delete. Then select the
Delete option (press D from the Directory Service Screen) to delete
that directory. If the directory does not contain any files or have
any sub-directories, it will be deleted and the screen will be
updated to reflect the change. If, however, the directory contains
one or more files or sub-directories, a warning message will be
displayed and the directory will not be deleted. If you still wish
to delete the directory, you must first delete all files and
sub-directories that it contains (See Delete File(s) under File
Operations.)
Note: There is a special situation when the directory has been set
by some other program to HIDDEN or READ/ONLY. In this case, you will
be notified that it is a special directory and you should see your
manual before deleting it. These special directories are sometimes
set by copy protection programs and, under normal circumstances,
should not be deleted. Chances are they cannot be recreated exactly
the same way. You should not delete these directories unless you
know why they exist on your system and how to recreate them properly.
page 15
Rename a Directory --------------------------------------------------
Command: R
Screen: Directory Service Screen
Synopsis: Renames the highlighted directory
To rename a directory, simply highlight the directory on the
Directory Service Screen that you wish to rename. Then select the
Rename option (press R from the Directory Service Screen) and you
will be prompted for the new directory name. Type the new name and
press <ENTER>. If the name is valid and does not conflict with other
directory names, the directory will be updated and displayed on the
screen. If there is a problem with the name, a warning message will
be displayed and you will be given a chance to enter a different
name. If your user setup specifies that the directories are
displayed in alphabetical order, you may re-scan your drive with the
ScaN option. The new directory will then be displayed in alphabetical
order. If you change your mind and elect not to rename a directory
before you have completed the operation, just press <ESC> to cancel
the operation.
Note: There is a special situation when the directory has been set
by some other program to HIDDEN or READ/ONLY. In this case, you will
be notified that it is a special directory and you should see your
manual before renaming it. These special directories are sometimes
set by copy protection programs and, under normal circumstances,
should not be altered. Chances are they cannot be renamed exactly as
they were. You should not rename these directories unless you know
why they exist on your system and how to rename them properly.
Section 4
File Operations
=====================================================================
The File Service Screen ---------------------------------------------
The File Service Screen is used for executing most file operations.
This screen is displayed when a single directory is selected from the
Directory Service Screen or when all files and directories are
selected by using the Global option from the Directory Service
Screen. The four major areas of the File Service Screen are:
1) Directory/Disk Status Box
2) File Display
3) Directory Pathname
4) Menu Bar
Directory/Disk Status Box - The directory status box is found at the
left side of the screen. If a single directory was selected, this
status box will display Directory Stats. If, however, the Global
option from the Directory Service Screen was used to select the files
for the File Service Screen, the status box will display Disk Stats
(since the files displayed represent all the files on the logical
disk drive.) The Directory/Disk Status Box contains the following
information: 1) the filename mask and attribute mask used to select
the files that are currently displayed, 2) the total number of files
selected, regardless of the above mask (i.e. includes all files,
hidden or system, etc.) and their cumulative size in bytes, 3) the
number of selected files and their cumulative size in bytes, 4) the
number of tagged files and their cumulative size in bytes, and 5) the
number of untagged files and their cumulative size in bytes.
File Display - The selected files are displayed in a box on the right
side of the screen. The actual file display comes in two flavors,
Normal and Extended. The normal display shows only the filename and
lists the files in four columns. This mode is useful for displaying
a large number of files on the screen at one time. The extended file
display shows fewer files on the screen at one time but gives you
much more information about each file. The following is a list and
page 17
description of these items:
Name - The left eight characters of the filename.
Ext - The right three characters of the filename.
Size - The size of the file in bytes.
Date - The date the file was last edited.
Time - The time the file was last edited.
Arc - If set, this indicates the file had been modified at one
time. This Archive attribute is generally used by backup
utilities for flagging which files to backup. Most files
will have this bit set.
Sys - If set, this indicates that the file is a System file
generally used by the operating system (DOS.)
Hid - If set, this indicates that the file should be Hidden
from the DIR command and certain other programs.
R/O - If set, the file is Read/Only and cannot be easily
modified or deleted.
Directory Pathname - The full pathname of the selected directory is
displayed on the bottom line. If the Global option (all directories)
was used to select the files, the pathname of the highlighted file
will be displayed. Notice how the pathname changes as you change the
highlighted file when in Global mode.
Menu Bar - The menu items available are displayed on two lines near
the top of the screen. The single letter command or key required to
select a menu item is highlighted for quick reference. Typing the
first letter of a menu selection will execute most commands. An
alternate menu bar will appear if you press the Alt key. The menu
selections available when the Alt key is depressed generally affect
tagged files.
Mouse Users: You may click on the menu selection Alt-menu found in
the upper right corner of the menu bar. This is
analogous to pressing the Alt key at the keyboard.
Holding the left mouse button down after clicking on
this selection will keep the alternate menu bar
displayed. You may drag the mouse cursor to a desired
menu item then release the mouse button to select that
option. Releasing the mouse button when the mouse
cursor is not positioned on a menu item will cancel
the Alt-menu selection.
page 18
About File Operations -----------------------------------------------
Most file operations are executed from the File Service Screen
although a few file operations are executed from the Directory
Service Screen. File operations include copying, moving, deleting,
viewing, editing, executing, printing, changing date/time, tagging,
untagging, re-tagging, and sorting files.
Single file operations act on the highlighted file displayed on the
File Service Screen. For example, if you wish to copy just one file
from one disk drive to another you need only highlight that file then
select the Copy option from the top menu bar. You will then be
prompted for additional information to copy that file. If, however,
you wish to copy several files, you would first have to tag those
files. Once tagged, you must select the Alt-Copy option from the
File Service Screen. To do this, hold down the ALT key first then
press C to copy. You will then be prompted for additional
information to copy the tagged files.
About Tagging Files -------------------------------------------------
Tagging files is a very powerful way of dealing with files as a
group. Many operations that you could do on a single file can be
executed on a group of tagged files. You can see which operations
may be executed on either single or tagged files by pressing and
releasing the ALT key from the File Service Screen and watching the
menu bar at the top of the screen change. Generally, if you wish to
operate on a single file, you need only make the selection from the
menu bar without pressing the ALT key. If, however, you wish to
execute that same operation on tagged files, press the ALT key before
making your menu selection.
Once tagged, you can execute an operation such as copying tagged
files that will systematically copy all the files that you have
tagged. After copying, the once tagged files are set to a limbo
state where you can easily retag or just ignore them. This is handy,
for example, if you wish to copy some files from your hard disk to a
floppy disk then delete those files on your hard disk. You would
first tag the files you wish to copy then execute the Alt-Copy option
to copy the tagged files. Once completed, you could retag just the
files you just copied by executing the Alt-RetaG option. Now select
the Alt-Delete option to delete the tagged files from your hard
drive.
Files can be tagged from either the Directory Service Screen or the
File Service Screen. Tagging files from the Directory Service Screen
is handy for tagging groups of files in directories or for the entire
logical drive. If you wish to more selectively or individually tag
files, you must do this from the File Service Screen. For example,
tagging files based on various criteria such as the date and time a
file was last edited, its attributes, a filename mask, or other
specific criteria, is done from the File Service Screen.
page 19
Files can be untagged by the same criteria that is used to tag files.
For example, you wish to backup (to floppies,) all files on your hard
drive except files having the .BAK extension. You would do this by
tagging all the files on your hard drive from the Directory Service
Screen using the Alt-Tag. option. Next you would choose the Global
option to select all files and change you to the File Service Screen.
From here, you would select the Alt-Untag option, then the Mask
option, allowing you to untag files based on a filename mask. Type
*.BAK to untag those files, leaving the remaining files on your hard
drive tagged. Last, you would select the Alt-Copy option to copy the
tagged files to your floppy disks.
TreeTop does not forget about your tagged files as you move from
screen to screen or directory to directory. This gives you the
ability to move freely about your hard drive, tagging and untagging
files until you are satisfied with the files you have tagged. Once
you are done tagging files, you can then execute options that act on
those tagged files.
page 20
Tag/Untag a Single File ---------------------------------------------
Command: T
Screen: File Service Screen
Synopsis: Tags the highlighted file then advances the
highlighted bar to the next file
Command: U
Screen: File Service Screen
Synopsis: Untags the highlighted file then advances the
highlighted bar to the next file
Select the Tag or Untag option (press T or U from the File Service
Screen) to tag or untag the highlighted file. If you tagged the
file, a caret is placed next to the that file to alert you that it is
tagged. If you untagged a file, the caret is removed. As you tag or
untag files, the highlighted bar is moved to the next file on the
screen so you can quickly move through the files.
Mouse Users: Mouse users can first click on a file to highlight it,
then click again on that file to tag or untag it.
Clicking on a highlighted file toggles that file
between tagged and untagged status.
page 21
Tag/Untag Multiple Files --------------------------------------------
Command: Alt-T
Screen: File Service Screen
Synopsis: Opens a menu of options to tag files based on
different criteria
Command: Alt-U
Screen: File Service Screen
Synopsis: Opens a menu of options to untag files based on
different criteria
Command: T
Screen: Directory Service Screen
Synopsis: Tags all selected files in the highlighted directory
Command: U
Screen: Directory Service Screen
Synopsis: Untags all selected files in the highlighted directory
Command: Alt-T
Screen: Directory Service Screen
Synopsis: Tags all selected files on the entire logged drive
Command: Alt-U
Screen: Directory Service Screen
Synopsis: Untags all selected files on the entire logged drive
Files can be tagged or untagged in groups from either the File
Service Screen or the Directory Service Screen. Tagging/Untagging
files from the File Service Screen provides the most control for
tagging multiple files. Keep in mind, if you have entered the File
Service Screen for a single directory with the "select" option, you
can only tag/untag files within that directory. If, however, you
have entered the File Service Screen using the Global option, you
will be tagging/untagging files on the entire logical drive. If you
wish to tag/untag files from the File Service Screen, select the
Alt-Tag or Alt-Untag option (press Alt-T or Alt-U from the File
Service Screen) and a menu of items will appear. All options on this
menu will only tag/untag files that have been selected for the File
Service Screen. If you select the first option on this menu, all
files that are currently selected for the File Service Screen will be
tagged/untagged. If you select the second option, you will be given
the opportunity to tag/untag files based on a filename mask. Only
the files that match the mask you type in will be tagged/untagged.
Then next four options allow you to tag/untag files based on the
files' attribute settings. You can also tag/untag files that have a
date/time stamp that matches today's date. This might be handy for
tagging files that you have edited today and want to make a copy to a
floppy disk. The last way to tag/untag a group of files from this
menu is to select a date/time range. All selected files meeting that
range will be tagged/untagged.
page 22
Tagging or untagging files from the Directory Service Screen is less
selective than from the File Service Screen, but is handy for
tagging/untagging all selected files for specific directories or for
the entire logged drive. Select the Tag or Untag option (press T or
U from the Directory Service Screen) to tag/untag all the selected
files in the highlighted directory. If you wish to tag/untag the
files in other directories as well, just change the highlighted
directory and select the Tag or Untag option again.
Select the Alt-T or Alt-U option (press Alt-T or Alt-U from the
Directory Service Screen) to tag/untag all the selected files for the
entire logged drive. This is especially handy for backing up your
hard drive.
Note: Before you can execute any file operations other than tagging
or untagging files (such as copying and deleting) you must first
select the File Service Screen. Also, if you have tagged files in
more than one directory, you may want to select the File Service
Screen using the Global option.
page 23
Set File Display ----------------------------------------------------
Command: Alt-F
Screen: File Service Screen
Synopsis: Toggles the file display screen between extended and
normal display modes
Select the Alt-File display option (press Alt-F from the File
Service Screen) to toggle between extended and normal file display
modes. The normal display mode shows only the file names and
extensions of the files, while the extended file display mode show
the size, date, time and attribute settings as well.
Retag Files ---------------------------------------------------------
Command: Alt-G
Screen: File Service Screen
Synopsis: Retags files that were once tagged but are currently
in the limbo state
Select Alt-RetaG (press Alt-R from the File Service Screen) to retag
files that are in the limbo state.
Retagging files is a feature that allows you to execute several
different operations on the same group of files. Files that had been
tagged and then acted on with a tagged file operation (such a copying
tagged files,) get changed to a limbo state where they are no longer
tagged. However, they are not quite untagged either. A file in this
state is denoted by a white diamond next to it. These files are
treated as untagged files by all operations except the Alt-RetaG
command.
Changing files to this limbo state gives you the ability to abort any
file operation, at any time, and TreeTop will know which files have
been processed and which files have not. If a tagged file operation
is allowed to go to completion, all the selected tagged files will be
in this limbo state. The Alt-RetaG option changes files in this
limbo state to tagged again. This gives you the ability to tag
files, process them, retag them and process them again. For example,
you may wish to delete a group of files. First, however, you want to
make sure that none are set to Read/Only. To do this, you would tag
the appropriate files, then execute the set tagged files' attributes
(Alt-Attr) option, setting them to Read/Write (not Read/Only.) Next,
you would retag those same files using the retag files option
(Alt-RetaG), then execute the delete tagged files option
(Alt-Delete.)
page 24
Find a File ---------------------------------------------------------
Command: F
Screen: Directory Service Screen
Synopsis: Finds a file or files on the entire logical drive
regardless of how the file and attribute masks are
set
Select the Find option (press F from the Directory Service Screen).
A window will appear in which you can type in the filename you wish
to find or a filename mask of files you wish to match. Type the
filename or mask you wish and press <ENTER>. Find will search the
entire logical drive and display all matching files showing you their
full pathname. Find is especially useful for locating files that may
not be included in the default attribute or file mask and checks all
files regardless of how these parameters are set. Since TreeTop
already knows about all the files on the disk, Find executes in a
fraction of a second because no disk access is required.
Edit a File ---------------------------------------------------------
Command: E
Screen: File Service Screen
Synopsis: Invokes your editor for the highlighted file
You must first enter the name of your editor in the User Setup
portion of TreeTop. If you have not yet done this, refer to User
Setup under the Installation Section.
Highlight the file you wish to edit, then select the Edit option
(press E from the File Service Screen). Your editor will be
automatically executed with the file you highlighted just as if you
had typed it from the DOS command line. When you finish editing the
file, save and exit your editor as you normally would, and you will
be returned back to TreeTop. Treetop will automatically rescan your
disk drive so it will be aware of any changes you may have made while
editing.
page 25
Execute a File ------------------------------------------------------
Command: Alt-X
Screen: File Service Screen
Synopsis: Executes the highlighted file then returns to Treetop
Highlight the file you wish to execute, then select the Alt-eXecute
option (press Alt-X from the File Service Screen). A window will
appear with a prompt similar to your DOS command line and the name of
the highlighted file. At this point, you can enter additional
arguments to the command line, or even edit the name of the
executable file. When you are satisfied with the command line, just
press <ENTER> to start the execution. When the program execution is
complete, you will be automatically returned to TreeTop.
Note: You can only execute three types of files. These are files
with an extension of BAT, COM or EXE. If you attempt to execute a
file with a different filename extension, the command line window
will still appear but the filename will be absent from the window.
page 26
Set File(s) Attributes ----------------------------------------------
Command: A
Screen: File Service Screen
Synopsis: Opens a menu to set the file attributes for the
highlighted file
Command: Alt-A
Screen: File Service Screen
Synopsis: Opens a menu to set the file attributes for tagged
files
Select the Attr option (press A from the File Service Screen) to
change the attributes of the highlighted file, or select the Alt-Attr
option (press Alt-A from the File Service Screen) to change the
attributes of tagged files. A menu will appear with two choices:
1) Change Attributes
2) Change Date/Time
Select the Change Attributes option.
If you are changing only the highlighted file, a second menu listing
the current settings of that file will be displayed. Attributes that
are currently set will have a check mark next to them. You may
change these attributes to your desired settings using the pull down
menu commands. When you are done setting the attributes, press <TAB>
to accept the changes or press <ESC> to cancel them.
The menu displayed for changing the attributes of tagged files
differs slightly from the one just described. This menu allows you
to set the desired attributes on or off as needed, or leave them
unchanged. This is handy, for example, if you wish to set a group of
files to Read/Only but do not wish to change the status of the other
three attributes, which may vary from file to file.
page 27
Set File(s) Date/Time -----------------------------------------------
Command: A
Screen: File Service Screen
Synopsis: Opens a menu to set the date and time of the
highlighted file
Command: Alt-A
Screen: File Service Screen
Synopsis: Opens a menu to set the date and time of tagged files
Select the Attr option (press A from the File Service Screen) to
change the date and time of the highlighted file, or select the
Alt-Attr option (press Alt-A from the File Service Screen) to change
the date and time of tagged files. A menu will appear with two
choices:
1) Change Attributes
2) Change Date/Time
Select the Change Date/Time option.
If you a changing only the highlighted file, a second window showing
the current date and time of that file will be displayed. You may
edit the date and time for that file using your arrow keys to move
about the window. When completed, press <RETURN> to accept the
changes or press <ESC> to cancel them.
The window displayed for changing the date and time of tagged files
will show the current date and time. You may edit the date and time
using your arrow keys to move about the window. When completed,
press <RETURN> to set the tagged files to the new date and time or
press <ESC> to cancel the operation.
page 28
Set File Selection Masks --------------------------------------------
Command: F
Screen: File Service Screen
Synopsis: Opens a menu of options allowing the user to set the
file masks in any of several ways
The file selection masks are used by TreeTop to determine which files
should be selected for display on the File Service Screen. There are
two file selection mask: 1) the filename mask, and 2) the file
attributes mask. The filename mask is used by TreeTop to match
selected files. Normally, this mask is set to ????????.??? which will
match all files. For example, if you wish to select on only the .COM
files, then you would set the file mask to ????????.COM. This would
instruct TreeTop to select all the files, regardless of their
filename, as long as the filename extension was .COM. You could be
more specific about which files you select by substituting letters or
numbers in place of the question marks. When entering a file mask,
you can use the asterisk character (*) as a short hand for all the
question marks on either side of the period in the file name because
the asterisk will automatically get expanded to the correct number of
question marks. For example, ????????.COM would match the same files
as *.COM.
The other file mask, the file attribute mask, is used to mask out or
hide files from being selected. For example, if you did not wish to
select on files that are hidden, you could check the HIDDEN bit of
the attribute mask and TreeTop would ignore any hidden files,
regardless of how the filename mask was set. The default
installation of TreeTop is set this way since you do not normally
want to see your hidden files.
Selecting the File sel option (press F from the File Service Screen)
will open a menu that gives you four options:
1) Set Filename Mask
2) Set Mask Attributes
3) Select Tagged files only
4) Reset to default settings
Choosing the first option opens an additional window that allows you
to type in the actual filename mask you wish TreeTop to use when
selecting files. You may use any legal combination of filename
characters, including questions marks (?) and asterisks (*.)
Choosing the second option opens another menu showing the current
settings for the file attributes mask. Using pull-down menu
commands, set the file attributes mask to your desired setting. When
you are done setting these attributes, you can press <TAB> to accept
the changes or press <ESC> to cancel them.
Choosing the third option overrides the filename and attribute masks
and instructs TreeTop to select only on tagged files, regardless of
filenames or file attributes.
page 29
The fourth and final option is used to reset the file masks to the
default settings found in the setup parameter file that was initially
read by TreeTop when you executed TreeTop from the DOS prompt.
page 30
Set Tagged File Mask ------------------------------------------------
Command: F5
Screen: File Service Screen
Synopsis: Toggles the files selected for the File Service
Screen between files that are tagged and files that
meet the conditions of the filename and attribute
masks
Select the F5-Tg'd Mask option (press F5 from the File Service
Screen) to toggle the files selected for the File Service Screen
between files that are tagged or files that meet the conditions of
the filename and attribute masks. When tagged files are used as the
criteria for selecting files, a red warning message is displayed in
the directory status box on the left side of the screen in place of
the actual mask that would normally be used for selecting files.
When toggled back to the normal condition of selecting files based on
their filename and attribute mask, the warning is removed.
Sort Files ----------------------------------------------------------
Command: Alt-S
Screen: File Service Screen
Synopsis: Opens a menu to choose the criteria used for sorting
the files on the File Service Screen
Select the Alt-Sort option (press Alt-S from the File Service Screen)
to open a menu of sort criteria. The current sort criteria used for
sorting the files in the File Service Screen are checked. You can
select new sort criteria using the pull-down menu commands. Press
<TAB> to accept the new sort criteria or <ESC> to cancel. The new
sort criteria will remain in effect for the remainder of the session
(regardless of which directory is subsequently viewed) or until it is
changed again.
page 31
Copy File(s) --------------------------------------------------------
Command: C
Screen: File Service Screen
Synopsis: Copies the highlighted file to a specified drive and
directory
Command: Alt-C
Screen: File Service Screen
Synopsis: Copies tagged files to a specified drive and directory
Both types of copy file operations (highlighted file and tagged
files) are executed from the File Service Screen. The menus that
prompt you are the same for both cases barring one exception. That
exception is the feature that allows you to copy a single file (the
highlighted file) while changing the name of the destination file.
Select the Copy option (press C from the File Service Screen) to copy
the highlighted file. A window appears showing you the name of the
source file and the default name of the destination file. If you
wish to edit the destination filename, do so at this time, then press
<ENTER> to accept the new destination name. To keep the default
(original) name, just press <ENTER> without editing.
Selecting the Alt-Copy option (press Alt-C from the File Service
Screen) allows you to copy the tagged files. Once the copy file(s)
option is selected, a list of destination disk drives will appear for
your selection. Upon selecting a drive, another menu appears that
gives you four options:
1) Scan disk first
2) Duplicate source sub-directories
3) Copy to Root
4) Enter destination path
Choosing the first option (Scan disk first) instructs TreeTop to scan
the destination disk drive for directories and display them in a
window similar to the Directory Service Screen. From this window you
may choose which directory you want to copy your files to by moving
the highlighted bar to the desired directory then pressing <ENTER> to
start the copy operation.
Mouse Users: You can simply click on the desired directory to
highlight it, then click on that directory again to
start the copy operation. If the desired directory is
outside of the window, click and hold down your mouse
button with the cursor just outside of the window to
scroll the directory structure.
Choosing the second option (Duplicate source sub-directories) starts
the copy operation and instructs TreeTop to copy the file(s) into a
subdirectory on the destination disk drive that has an identical path
to the source disk drive. If the path does not exist on the
destination disk drive, TreeTop will automatically create it.
page 32
Choosing the third option (Copy to Root) starts the copy operation
and instructs TreeTop to copy the file(s) into the root directory of
the destination drive.
Choosing the fourth and last option (Enter destination path) opens an
additional window that allows you to enter the name of the
destination path you wish to copy files to. This option is handy if
you know the name of the path you wish to copy to, but do not wish
to wait for the destination disk to be scanned first. TreeTop
recalls the destination pathname of the last copy operation to this
window. You simply type in the destination pathname or edit the
existing pathname in the window, then press <ENTER> to start the copy
operation.
Note: You may fill the destination disk drive while copying files.
TreeTop handles this situation gracefully, informing you of the
available disk space on the destination disk drive and the size of
the file that it is trying to copy. At this point, you are given the
opportunity to skip that file and to try copying the next file, or
cancelling the copy operation so that you can deal with the full
disk. If you cancel the copy operation while you are copying to a
floppy disk, you may want to insert a freshly formatted blank floppy
disk into the disk drive and resume copying. TreeTop keeps track of
the tagged files it has already copied so you can pick up where you
left off. In all cases, you can cancel the copy operation while you
are copying files by pressing <ESC>, then resume where you left off
by selecting the copy option from the menu again.
page 33
Move File(s) --------------------------------------------------------
Command: M
Screen: File Service Screen
Synopsis: Moves the highlighted file from one directory to
another directory on the same logical drive
Command: Alt-M
Screen: File Service Screen
Synopsis: Moves tagged files from one directory to another
directory on the same logical drive
Select the Move option (press M from the File Service Screen) to move
the highlighted file, or select the Alt-Move option (press Alt-M from
the File Service Screen) to move tagged files. Either option will
prompt you with a directory tree structure of the current logged
drive. This tree structure is similar to the one on the Directory
Service Screen. From this window you may choose which directory you
want to move your file(s) to by moving the highlighted bar to the
desired directory then pressing <ENTER> to start the move operation.
You may cancel the move operation at anytime by pressing <ESC>.
Mouse Users: You can simply click on the desired directory to
highlight it, then click on that directory again to
start the copy operation. If the desired directory is
outside of the window, click on your mouse cursor just
outside of the window to scroll the directory
structure.
Note: When using the move file commands, you are limited to moving
the file(s) within the same logical drive on which they exist. This
is because the move operations do not actually move any data, but
changes the directory entries and FAT (file allocation table) entries
that tell DOS where the file(s) is located. The move operations are
extremely fast because they efficiently move files (regardless of the
size of the files) from one directory to another on the same logical
drive.
If you wish to move a group of files from one logical drive to
another, you can do so by using TreeTop's copy and delete routines.
First tag the files you wish to move, then select the Alt-Copy option
(see Copy File(s) under File Operations) to copy the tagged files to
another drive. When that operation has been successfully completed,
select the Alt-RetaG option (see Retag Files under File Operations)
to retag the files you just copied. Now select the Alt-Delete option
(see Delete File(s) under File Operations) to delete the files you
just copied.
page 34
Delete File(s) ------------------------------------------------------
Command: D
Screen: File Service Screen
Synopsis: Deletes the highlighted file
Command: Alt-D
Screen: File Service Screen
Synopsis: Deletes tagged files
Both the Del and Alt-Del options to delete files are executed from
the File Service Screen. To delete only the highlighted file, select
the Del option (press D from the File Service Screen). The name of
the file you selected will be displayed and you will be asked if it
is OK to delete that file. You can respond with Yes, No, or just
press <ESC> to cancel the delete operation.
To delete tagged files, select the Alt-Del option (press Alt-D from
the File Service Screen.) You will be asked if it is OK to delete
tagged files. If you respond with Yes, you will be asked if you wish
to be prompted. If you answer Yes, each tagged filename to be
deleted will be displayed and you will have the option of deleting or
saving that file. If you answer No, the tagged files will be deleted
and no more questions will be asked. You may cancel the delete
operation at any time by pressing <ESC>, but keep in mind, you cannot
undelete files TreeTop had already deleted up until the time you
pressed the escape key.
page 35
Print File(s) -------------------------------------------------------
Command: P
Screen: File Service Screen
Synopsis: Prints contents of the highlighted file
Command: Alt-P
Screen: File Service Screen
Synopsis: Prints contents of tagged files
Both the Print and Alt-Print options are executed from the File
Service Screen. To print only the highlighted file, select the Print
option (press P from the File Service Screen.) The name of the
highlighted file will be displayed, and you will be asked if it is
OK to print that file. You can respond with Yes, No, or just press
<ESC> to cancel the print operation.
To print tagged files, select the Alt-Print option (press Alt-P from
the File Service Screen.) You will be asked if it is OK to print
tagged files. You can respond with Yes, No, or just press <ESC> to
cancel the print operation.
You may cancel the print operation at any time by pressing <ESC>. If
your printer is off-line or not connected properly when you select a
print option, a warning message will be displayed informing you the
printer is not ready.
Rename a File -------------------------------------------------------
Command: R
Screen: File Service Screen
Synopsis: Renames the highlighted file
Highlight the file you wish to rename, then select the Rename option
(press R from the File Service Screen). The current name will be
displayed and you will be prompted for a new name. Any valid file
name that does not conflict with other files in the same directory
can be used. Type in the new name and press <ENTER>. If there is a
naming conflict, a warning message will be displayed and the file
will not be renamed.
page 36
File Speed Search ---------------------------------------------------
Command: F4
Screen: File Service Screen
Synopsis: Advances highlighted bar to filename matching user
input
Select the F4-Spd Srch option (press F4 from the File Service
Screen.) You will be prompted for a filename to search. TreeTop
tries to match a file in the selected directory or directories (if
Global) to the filename you are typing. It will continuously move
the highlighted bar to the matching file as you type. When no match
is found for the typed entry, TreeTop will ignore that character.
Once TreeTop has highlighted the file you desire, you can press
either <ENTER> or <ESC> to terminate File Speed Search. This is a
handy way to locate a file if you know its name and do not wish to
scroll through all the files manually.
Note: If searching for a specific file while in Global (Viewing All
Subdirectories), it is advisable to first sort the files
alphabetically. This way files of the same name will be grouped
together.
Hex File Dump -------------------------------------------------------
Command: H
Screen: File Service Screen
Synopsis: Displays the contents of the highlighted file in
hexadecimal form
Select the Hex option (press H from the File Service Screen.) The
highlighted file will be opened, changing you to the Hex Dump Screen
and displaying the first 256 bytes of the file in hexadecimal form
(base 16.) At the right of the Hex Dump Screen, the ASCII
representation of each byte is displayed. If the value of a given
byte is greater than the ASCII range, the IBM block mode graphics
character is displayed. You may move through the file, displaying
other 256 byte records using your Home, End, PageUp, and PageDown
keys. If you wish to view a specific 256 byte record, you can select
the Goto (press G) option at the top of the Hex Dump Screen. This
option allows you to Goto any 256 byte record in that file. When you
have finished viewing the file, you may press <ESC> to exit the Hex
Dump Screen.
Mouse Users: Mouse users can click on the bottom of the screen to
view the next record or near the top of the screen
(but below the menu bar) to view the previous record.
page 37
View a File ---------------------------------------------------------
Command: V
Screen: File Service Screen
Synopsis: Displays the contents of the highlighted file in text
form
Select the View option (press V from the File Service Screen). The
highlighted file will be opened, changing you to the File View Screen
and displaying the first 19 lines of that file. You may move through
the file one page at a time using your PageUp and PageDown keys or
one line at a time using your up and down arrow keys. The Home and
End keys move you to the first and last pages of the file, while the
left and right arrow keys will shift the file left or right 10
characters. When you have finished viewing the file, press <ESC> to
exit the File View Screen.
Mouse Users: Mouse users can click on the bottom of the screen or
near the top of the screen (but below the menu bar) to
scroll the file vertically. You can also click on the
left and right sides of the screen to scroll the file
horizontally.
Section 5
Miscellaneous Operations
=====================================================================
The remaining operations described in this section consist mostly of
disk drive commands. All the commands listed in this section can be
executed from the Directory Service Screen and many can be executed
from the File Service Screen.
page 39
Registration Information --------------------------------------------
Command: I
Screen: Directory Service Screen
Synopsis: Displays registration information for TreeTop
Select the Info option (press I from the Directory Service Screen) to
display the Registration Information Screen. This screen contains
information instructing you how to permanently register your TreeTop
software.
Available Disk Space ------------------------------------------------
Command: S
Screen: Directory Service Screen or File Service Screen
Synopsis: Displays the available disk space for a given drive
Select the Space option (press S from either the Directory Service
Screen or the File Service Screen). A menu of logical drives is
displayed. Press the letter of the drive you wish or press O for
Other Drive if the disk drive you want is not on the menu. If you
pressed O, a box will appear for you to enter the drive you want.
After selecting a drive, the available disk space is displayed in
another window. If the drive you selected is not ready or does not
exist on your system, a warning message will be displayed. If this
happens, you can press <ESC> to cancel the Space request or ready the
drive and select it again. When you have completed checking
available space on your logical drives, press <ESC> to return.
Logging to a Different Drive ----------------------------------------
Command: L
Screen: Directory Service Screen or File Service Screen
Synopsis: Changes to a new drive and scans that drive for its
files and directories
Select the Log drive option (press L from either the Directory
Service Screen or the File Service Screen). A menu of logical drives
is displayed. Press the letter of the drive you wish or press O for
Other Drive if the disk drive you want is not on the menu. If you
pressed O, a box will appear for you to enter the drive you want.
After selecting a drive, TreeTop scans that drive for all files and
directories, just as it did when you first executed TreeTop. If the
drive you selected is not ready or not available on your system, a
warning message is displayed. If this happens, you can press <ESC>
to cancel the Log drive request or ready the drive and press <ENTER>
to try again.
page 40
Setting the Disk Volume Label ---------------------------------------
Command: V
Screen: Directory Service Screen
Synopsis: Sets the volume label for the currently logged drive
Select the Volume option (press V from the Directory Service Screen)
to set the volume label for the current logged drive. A window will
appear allowing you to enter a new volume label. If a volume label
currently exists on the logged drive, then it will be changed to the
new label. If there is no previous label, then one will be created.
If you wish to delete the volume label, just press <ENTER> without
typing a new label. If you wish to cancel the operation, press
<ESC>.
Scanning the Current Drive ------------------------------------------
Command: N
Screen: Directory Service Screen
Synopsis: Rescans the currently logged drive for its files and
directories
Select the ScaN option (press N from the Directory Service Screen) to
rescan the current logged drive. This feature is useful if you have
logged onto a removeable media disk drive (i.e. a floppy drive) and
you wish to change floppies. Rescanning forces TreeTop to reread all
the directory and file entries for the logged drive and set any
previously tagged files to untagged status. You may wish to use this
command if you have tagged a number of files throughout the
directories and you want to have a fresh look at the drive.
Shelling To DOS -----------------------------------------------------
Command: F3
Screen: Directory Service Screen or File Service Screen
Synopsis: Temporarily exits TreeTop by executing your command
interpreter
Select the F3-DOS Shell option (press F3 from either the Directory
Service Screen or the File Service Screen). As a precaution, you
will be asked if you wish to shell to DOS. Press <ESC> or answer No
to cancel the command. Answering Yes causes TreeTop to invoke your
command interpreter, returning you temporarily to the DOS prompt in
the directory you were at when you selected the F3-DOS Shell option.
Keep in mind that you actually suspended TreeTop, and it still
resides in memory. Type EXIT then press <ENTER> at your DOS prompt
to return to TreeTop. TreeTop will automatically rescan your logged
drive to check for any files or directories you may have changed.
page 41
Exiting TreeTop -----------------------------------------------------
Command: <ESC>
Screen: Directory Service Screen
Synopsis: Quits TreeTop and returns you to your original
directory
Command: F2
Screen: Directory Service Screen or File Service Screen
Synopsis: Quits TreeTop and places you in the current logged
drive and directory
There are two ways you can quit TreeTop. The first and most common
way is by selecting the ESC-Quit option (press <ESC> from the
Directory Service Screen). As a precaution against accidentally
exiting, you will be asked if you want to exit TreeTop. Answer No or
press <ESC> to cancel the command and continue running TreeTop.
Answer Yes to quit TreeTop and return to your DOS prompt in the same
drive and directory that you originally ran TreeTop from.
The second way of quitting TreeTop allows you to change to the
current logged drive and directory while exiting. Select the F2-Exit
to dir option (press F2 from either the Directory Service Screen or
the File Service Screen). As a precaution against accidentally
exiting, you will be asked if you want to exit TreeTop. Answer No or
press <ESC> to cancel the command and continue running TreeTop.
Answer Yes to quit TreeTop and return to your DOS prompt in the drive
and directory that was TreeTop's logged drive and directory when you
executed the command.
INDEX TO OPERATIONS
Operation Cmd Scrn* Pg Synopsis
---------------- --- ----- -- -----------------------------------
Add a Directory A D 14 Adds a sub-directory to the high-
lighted directory
Copy files(s) C F 31 Copies the highlighted file to a
specified drive and directory
Alt-C F 31 Copies tagged files to a specified
drive and directory
Delete Directory D D 14 Deletes the highlighted directory
Delete File(s) D F 34 Deletes the highlighted file
Alt-D F 34 Deletes tagged files
Edit a File E F 24 Invokes your editor for the high-
lighted file
Execute a File Alt-X F 25 Executes the highlighted file then
returns to TreeTop
File Speed F4 F 36 Advances highlighted bar to filename
Search matching user input
Find a File F D 24 Finds a file or files on the entire
logical drive regardless of how the
file and attributes masks are set
Hex File Dump H F 36 Displays the contents of the high-
lighted file in hexadecimal form
Information I D 39 Displays TreeTop registration Info.
Logging to a L D/F 39 Changes to a new drive and scans that
Drive drive for its files and directories
Move File(s) M F 33 Moves the highlighted file from one
directory to another directory on the
same logical drive
Alt-M F 33 Moves tagged files from one directory
to another directory on the same
logical drive
Print File(s) P F 35 Prints the contents of the highlighted
file
Alt-P F 35 Prints the contents of tagged files
Quit TreeTop <ESC> D 41 Quits TreeTop and returns you to your
original directory
F2 D/F 41 Quits TreeTop and places you in the
currently logged drive and directory
*D = Directory Service Screen, F = File Service Screen, D/F = either screen
INDEX TO OPERATIONS (cont.)
Operation Cmd Scrn* Pg Synopsis
---------------- --- ----- -- -----------------------------------
Rename Directory R D 14 Renames the highlighted directory
Rename a File R F 35 Renames the highlighted file
Retag Files Alt-G F 23 Retags files that were once tagged but
are currently in the limbo state
Scanning Logged N D 40 Rescans the currently logged drive for
Drive its files and directories
Select All G D 13 Selects the File Service Screen for all
Directories directories on the logged drive
Select a <ENTER> D 13 Selects the File Service Screen for the
Directory highlighted directory
Set File Display Alt-F F 23 Toggles the file display between
extended and normal display modes
Set File Selec. F F 28 Opens a menu of options allowing the
Masks user to set the filename and attribute
masks in any of several ways
Set File(s) A F 26 Opens a menu to set the file attributes
Attributes of the highlighted file
Alt-A F 26 Opens a menu to set the file attributes
of tagged files
Set File(s) A F 27 Opens a menu to set the date and time
Date/Time of the highlighted file
Alt-A F 27 Opens a menu to set the date and time
of tagged files
Set Tagged File F5 F 30 Toggles the files selected for the File
Mask Service Screen between files that are
tagged and files that meet the cond-
itions of the filename and attribute
masks
Set Volume Label V D 40 Sets the volume label for the currently
logged drive
Setup Alt-S D 8 Opens a menu of options for customized
setup by the user
Shelling to DOS F3 D/F 40 Temporarily exits TreeTop by executing
the DOS command interpreter
Sort Files Alt-S F 30 Opens a menu to choose the criteria
used for sorting the files on the File
Service Screen
*D = Directory Service Screen, F = File Service Screen, D/F = either screen
INDEX TO OPERATIONS (cont.)
Operation Cmd Scrn* Pg Synopsis
---------------- --- ----- -- -----------------------------------
Space Available S D/F 39 Displays the available disk space for a
(disk) given drive
Tag a File(s) T F 20 Tags the highlighted file then advances
the highlighted bar to the next file
Alt-T F 21 Opens a menu of options to tag files
based on various criteria
T D 21 Tags all selected files in the high-
lighted directory
Alt-T D 21 Tags all selected files on the entire
logged drive
UnTag a File(s) U F 20 Untags the highlighted file then
advances the highlighted bar to the
next file
Alt-U F 21 Opens a menu of options to untag files
based on various criteria
U D 21 Untags all selected files in the high-
lighted directory
Alt-U D 21 Untags all selected files on the entire
logged drive
View a File V F 37 Displays the contents of the high-
lighted file in text form
*D = Directory Service Screen, F = File Service Screen, D/F = either screen